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Input absolutely anything 

TWO mqjor problems Applesoft programmers have udien trying to write 
polished soflware are the unpredictable delays caused by garbage collection 
and the inability of the inPUT command to accept commas or colons, Apple 
fixed the garbage collection problem with ProDOS and Open-zlpple has 

shown you how to control it under DOS 3.3 (Januaiy, pages 4-5; March, pages 
17-19). 

Apple also wanted ProDOS to fix the I!*1PUT command. Appendix B of Basic 
Programming with PmDOS says (page 207), 'The Applesoft INPUT command 
has been made more useful ... .When you use ProDOS, the last variable in the 
inPUT list is assigned all the remaining characters in the line, including 
commas and colons. This means that you can now use a single IMPUT 
statement to read in any arbitrary string of characters." Many people have 
been veiy excited about this feature. Unfortunate^, itfs only in flie manual — 
ProDOS and Basicsystem handle IWPUT exactly as Applesoft and DOS 3.3 
do, 

Abett«I«giiHB{]iiiiackiiie,Therea8on n*iPUTwon't accept commas o- 
odons is that A^di^oft vas i^iped so that semsi rariables could be 
input at rtieHmcConsidafftiisHtfle Applesoft pni^am: 

108 PRINT -ENTER VOUR NAME, AGE, AND EVE COLOR.- 

lie WUT NJ.fi.EI 

12a PRINT -THANKS- : END 

When you run this program, you can enter all three data elements at one 
time, separated by commas. Or you can enter them one at a time. If the data 
is entered correctly (a big assumption), here's what appears on the saeen in 
each situation: 

ENTER WlUR NWE, BEE, SnS EVE COLOR. 

?iiolly,B,bluish-brouri 

THANKS 

ENTER VOUR NflNE. AGE, AND EVE COLOR. 

?joe 

??brDunlsh-blue 
THANKS 

Basic vm dewicqxed in the 1970s, mdien trained apmWs entmd most 
computer data on kieypunch madiines. This kind of inPUT flexiblity seemed 
on the cutting edge of technology in those days, flow, however, after 
programs like GPtC, VisiCalc. and Apple Writer, INPUT seems absolutely 
deaepit 

There is no way you can write an Applesoft program that has data-entiy 
and editing fecilities as good as those in, say, AppleWorks. So why not use 
AppleWorks or a similar program for data entry instead of even bothering 
tiding to write your own data-enhy routines? If your data is mostly numbers, 
use a spreadsheet If it is mostly words, use a word processor. If it is a mix of 
different types of information that have a consistent format use a data base, 
tast month Open-Apple showed you how to get these kinds of data out of 
AppleWorks and into files you can manipulate with Applesoft programs. For 
tabular, numeric information, use DIF ftles. For other tjpes, use standard 

AsaitesAffles. 

The vmo^gbte GET loc^. ^ we E^ee that in 1^3 Api^esof s Mm 
commaid shoul(ta'tbe used fbrmuch b^es resKfiig data off of cUsks. M 
unfortunately, because of the way its da%lopers ^ncyfied it back in the 



1970s, It doesn't ewm wMk veiy wdl for ttiA Consider happens when 
you tiy to read these lines of data from a disk file with INPUT: 

Route 4, Box 92 
Pascagaula, Mississippi 
Apple Computer, Inc. 
3/15/85 08:30 

In each case, an EXTRA IQMORED error message will appear on your 
screen (although program execution will continue uninterrupted) and you 
will lose ail information after the first comma or colon in a line. 

An easy way to solve the problem is to use a QET-loop instead of IFiPUT; 

198 BET AS : IF n$<>CHR*(13) THEN B$=flS+Rli : GOTO 100 

In a QET-loop like this one, W is a temporary variable. The completed 
string ends up in B$. 

There are three problems with this technique. First it is extremely slow. 
Second, it aeates tons of garbage. Third, if you attempt to input a line with 
more than 255 characters before a carriage return, you vuli get a STRIIiQ 
TOO LONG eiTor. 

(Applesoft sbings have a maximum length of 255 characters. The 
^plesdl mPUr Gomn^md, ho«ffirer, will accept only 239 characters. This 
appears to be because ITIPUT and the section of Applesoft that reads 
program lines you type on the keyboard share some important subroutines. 
Program lines are limited to 239 characters; because of the shared 
subroutines INPUT is too, but it doesn't have to be. Interestingly, Applesoft 
will allow you to enter 255 characters of both program lines and INPUT, but 
eveiything after character 239 is ignored without warning.) 

In the March OpewApple (page 22), subscriber Jim Parr gave us a nine 
line Applesoft sutnoutine that avoids the garbage-aeation and sblng-too- 
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long problems. It is suitable for any program that can access files casually. If 
you want to do some heavy-duty data input, however (like reading a couple 
thousand subscriber records of 30 fields each from a disk file), a QET-loop 
quickly adds minutes to program execution time. 

An historic look at input-anything routines. Because of the problems 
IMPUT and QET-loops have, Applesoft programmers have been looking for a 
better solution for a long time. The earliest input-anything subroutine 1 have 
heard of was published in Contact a programming newsletter Apple itself 
published in 1978 and 1979. The routine appeared in the October 1979 
issue, in the early days of Applesoft To use it the first variable you define in a 
program has to be X$. Then you have to poke in a short machine language 
program that starts at byte 768. Then, Instead of IMPUT "EMTER YOUR 
AHSVVER HERE:';A$,you ssQi: 

5M PRINT -ENTER YOUR RNSUCR HERE:'; 

519 CBLL 7EB : ni=liIDS(Xt,l) 

The assembly language routine at 768 calls the Monitor's riXTCHAR 
routine, which gets characters fi-om the keyboard or other input device, 
prints them on the saeen as they are fyped. stores them in the keyboard 
input buffer at $200, and stops (returning the length of the string in the X 
roister) wlien a return cbaracta is typed nxrctlARsui^^^ 
(and minimal) Monitor editii^ functions, sudi as back s^:e and forwad 
space, 

After using HXTQIAR to input the string, the routine puts the string's 
length and the address of the lieytioanl input buffer into the variable 
descriptor for X$. Applesoft uses variable descriptors to keep track of the 
current value of each variable. The variable descriptors are kept in a uariaijfe 
table Applesoft builds as a program executes. Each descriptor indicates to 
Applesoft what kind of variable ft describes (integer, real, string, fiinction, 
integer array real array string array); what the variable's two-character name 
is; and, for numeric variables, what the variable's value is. 

for string variables, the actual characters in the string are stored 
elsewhere. The January Open-Apple (page 4) has picture of this. The 
variable descriptor for a string, however, does tell Applesoft the string's 
length and where in memory ft is stored. 

Because X$ is the first simple variable we define in our program, its 
descriptor is at the veiy beginning of the variable tables. A zero-page location 
known as VARTAB ($69^70) always points to the beginning of the variable 
tildes, consequently the descriptor for is ea^ to find. The first of the 
input-fB^thing routbies relied on this. 

After caltQ on NXTCIURto (sllect flw sbii^ and put it hi the kqiboofd 
buSff, Ok iwiline puts Biestifaigfslengfe and flK address (tfttiebuRrbitD 
the variable desa^itDr fiv Xl!, as described earlkr. Wh« oMnd return 
the^iplesoft|HngrBm,thei^lD$(X$l) onnrnand Isaeort^ tdls 
Applesoft to make A$ equal to X$ tmm its first character onward. The 
command makes ApplescA dig X$ out of the buffer and move it as A$, up to 
the normal string storage tocation. A$=X$+ " ' works just as well; A$=X$ does 
not however. Pretty tricky, isn't it? 

The code this technique needs at 768 looks like this: 



em: 


R2 »» 


LDX UMe 


initialize string length to zero 


e3«2: » 75 ED 


JSR MOCHflR 


ctll Honltar's INPUT aubniutine 


e38S: 


m K 


LDV 8182 




»3»7: 


BR 


TXfl 


moye string length to 


ma: 


91 G9 


STfl (UflRTflSj.y 


store it in byte tuD of descriptor 


men-. 


CB 


INV 


for X» 


mm: 


PS m 


Lon usee 


put address of kBLfboard input buffer [S209) 


9380: 


91 69 


STfl (VflRTflB),V 


in bytes thm tnd four Df dascrlptor 


83er: 


CB 


INV 




8318: 


fl9 02 


LDfl «ie2 


note that this only uorks if XS la th» 


9312: 


91 G9 


STfl (VflRTfiB),y 


first variable in the yariablB tabli 


8314: 


W 


RTS 





This routine was written by John &ossley,whowenton to become famous 
in the Apple world as the person who named all the subroutines inside 
Apples(^ Apple itself has never released the source code to Applesoft but 
in an early issue of Apple Orchard Crossley named and documented its 
major useful subroutines. A copy of Crossley's article, "Applesoft Internal 
Entry Points," was republished in Call -A-RPl.E. in Depth #1; All About 
Applesoft, page 51 Crossley's names are now widely used in the Apple II 
worid. At the time Qossley wrote his article most assemblers allowed a 
madmum of^ diaracteis for labels. Thats why Applesoft's routines and 
locations are known tods^ such Gondse names as VARTAB. 



Crossley's input-anything routine a bug in it however, (its strings 
wouldn't evaluate correctly wttti the WL command) and ^)ple II hackers 
were soon improving it 

The June 1980 Call -A.P.P.LE. carried an improved "Input Anything 
Subroutine" by Eric Qoez on page 184; PEEKing at Call -A.P.P.LE., 1980 had 
the "Applesoft Input nearly Anything Subroutine ' by Val Qolding on page 
153; the March-April 1981 Call APPLE, had "Input Almost Anything " on 
page 54; Peter Meyer wrote 'The Ultimate Input-riearly-Anything Routine," 
which was published in Call -ARRLE.'s book All About Applesoft (released 
October 1981), page 94; then came Bob Macon's "The Penultimate Input- 
Anything Routine" in the January 1983 Call -APPLE., page 43. 

All of these routines were improvements of Crossley's original. Qoez 
solved the problem with the VAL function; Qolding showed how to tack the 
assembly language portion onto the end of an Applesoft program rather 
than using the space at byte 768; Meyer, after paying bibute to Crossley's 
article on Applesoft entry points, showed how to get rid of X$ and how to use 
the Ampersand command as well as CALL; dacon showed how to store new 
strings in the same place previous strings had been stored if Uie new ones 
were flie same length or shorta— a tiick th^ caused garbe^ collection to 
occur less fiwjuentjy. 

BvQi Unde Louie tried to in on flie acficm. Bert Kers^s June 1982 
DOStalk in Softalk, page W5. biduded an Applesoft routtne that caDed 
NXrCHARamltbendi^ttierraultii^sbingoutofthe keyboard input buffer 
with inSte. Onlbrtunatefy, it created as much garbage as a QET-loop, only 
slower. However, it didn't require an extra assembly language routine, nor 
was it called "Input " anything. For historical reasons, tihis routine, "Exfra 
Embraced ", appears in the DOStsdk Scrapbook on pages 20 and 21 

Yet another input-anything routine. As the Opeti-Apple subscription 
list grew over the last few months, it became clear that 1 would have to 
replace the QET-loop in my mailing label program with something faster if 
we were going to finish up \xSott the bars closed. First 1 tried Meyer's 
"Ultimate" routine and found that under ProDOS, it issues a carriage return 
every time liXTCflAR is called. Remember that the Open-Appie mailing 
program reads 30 fields per subscriber; that s a lot of carriage returns. Since 
my program read the file while the printer was on, I soon liad a little model of 
Victoria Falls splashing continuous paper all over the room. 

It turned out this problem is very easy to solve if you know the right perscm 
to ask about it (Cedl RretwelL who will be doing a question and answer 
column for iYibb(estBrtii^U^this}ear—]ioureaditlimfir5t),butby^ 
wasmad. 

Another probten mMi any input method that relies on the Monitor's 
nxraiARioat^istliataiiyescape8,oontrol-tls,Qonirol^,<MrGontroI-^ 
llie ffle dont mtfte it Into the final string, In 1^ a contrbl-X in the file 
eraseev«:ythingbacktothelastretum,Justasitdoeswhenyoutypeitonthe 
keyboard. In addition, if a sfaing is longer than 255 characters, as is often fiie 
case with vrord processor files, the fii^t 255 charaobera are deleted. Even a 
QET-loop can bypass this problem. 

This was the genesis of this month's "Input Absolutely Anything" routine. It 
loves com mas, colons, escapes, and anything else you want to throw at it As 
written, it uses the Ampersand hook, although you could easily change this 
to a CALL using the information given in Meyer' s article. (Don't try to make a 
Basicsystemadded-command out of it however.as PRirfT D$; "inPUTA$ "will 
turn your READ (M, as all DOS commands do.) As written, fiie assembly 
language portion of the routine is loaded at $300, but you could rdocate it 
anywhere, 

This input routine isn't meant to be used for keyboard input although I 
recommend you tiy using ft that way for demonstration purposes. Because it 
captures ALL control codes, you can't do AHY on-saeen editing. Pressing the 
back space key will just put a back space character on your screen (a 
flashing, inverse, or MouseText "H", depcndii^cmwhatvideo mode andwhat 
model of Apple II you are using). 

The IbDoA^irogcam wni gjhieyou some klea how to use the routine for 
keyboard input: 

1880 S flS 

1818 PRINT fl$ 

1820 IF LE:N(fl$) THEN 1088 

Watch what happens when you press the forward arrow, which aeates a 
control-U. Line 1000 will put this on the saeen as a flashing (or inverse or 
MouseText) U. When line 1010 prints it however, it will be sent to the saeen 
as a true control-U. If you have 80<olumn mode on, control-U always turns it 
off. This creates some interesting effects. Tb avoid ttion, tiy changing Ibie 
1010 to: 
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laie FOR 1=1 TO LEN(fll) : PPINT fl5C(MID« (fit, 1,1) ) ; " 



NEXT : PRINT 



This will print your string out as a series of ASCIIcodes and prove that our 
new routine loves characters of all ^)pes. 

To read a file with Input Anytttteg, substitute "fif A$" (or B$ or whatever$) for 
"INPUT A$". 

For the Ba^conly programmers among us, here's a program that will 
aeate a machine code file, called 1AA.0BJ, that holds the guts of Input 
Anything, l^pe it in, run ttonce, andthrtmit away (enter B where you see b; 
enter 8 where yon see B or 8): 

19 REM •»» Create Ififl.OBJ »«« 

20 PRINT "One moment please..." 

100 c$=-e3a0: m w bs 33 2b e3 of (q m 20 0c fd bb 29 7f- .- bdsub 500 

101 C$="930F: C9 0D 0B 4B FB 07 C9 20 b0 03 69 40 flB 9B 20" : GDSUB S00 

102 C$="031E: ED FD GB 2B F0 0D 9D 00 02 E9 E0 FF D0 DD fi9~ : GOSUB 500 

103 CI="032D: 0D 20 ED FD BG FD Bfl fl0 00 Dl B3 F0 02 b0 IF" : GDSUB 500 

104 CJ="933C: 91 93 C8 bl B3 85 71 4B CB bl B3 85 72 C5 28" : G05UB 500 

105 Ct="a3<tb: B8 90 0D C5 GF 90 09 8H f)2 00 fl0 02 20 E2 E5" : GOSUB 500 

106 Ct="03SR: G0 BB 20 52 E4 Ki 00 B0 02 20 E2 ES fi0 00 fi5" : EOSLIB 500 

107 CI=-e3S3: FD 91 83 CB B5 GF 91 63 CB fl5 70 91 83 66" : GOSUB 500 

110 FOR I=7SB TO m ; X=XtPEEK(I) : NEXT 
129 ir X=15279 THEN 290 

139 PRIST 'TRflNSERIPTION ERROR. CHECK CJ STRINGS." : END 
299 PRINT CHR$(4);*BS(iVE Iflfl.OBJ,fll30e,L$77" 

219 PRINT "infl.OBJ IS OK m HftS BEEN 5RVED." 
229 END 

599 CI=C$t" N D9CeG" : REM 5.H. Lfln ROUTINE 

595 FOR 1=1 TO LEN (C$) : POKE Sll+I, flSC(l1ID*(C*,I,l))tl2B : NEXT 
Sie POKE 72,4 : CBLL -144 : RETURN 

Here's an Applesoft routine that will install your new IAA.OBJ file in 
memory and link it to the Ampersand hook under either DOS 3.3 or ProDOS. 
note that it checks the status of the Ampersand hook and will refuse to 
continue if another program is already using it Really good Ampersand 
routines are able to save the contents of the Ampersand hook and daisy- 
chain to previously-installed routines if necessary. There was neither space 
nor time for that ttiis month. Run this to install our newinput routine: 

19 REM »*» INSTBLL IfiB.DBJ «»« 
199 REM get contents of 4 hook 
110 SMP=PEEI<( 1014 ) +PEEK( 1015) «25G 



129 



REM determlnB uihether DOS 3.3 or ProDDS is actluo 
IF PEEK (PEEK(977) + PEEK(97B) » 256) = 7G THEN 159 



119 REM — DOS 3.3— 

129 IF fiHP < > 65368 THEN 390 ! i hook in use If not SFFSB (RTS) 

139 X=191 : REM a JBF to stuff at i39i for prompt 

149 GOTO ^99 



Peekers pokers, and probers of DOS .^.3 may be interested to Know 
that all of Bert Kersey's DOStalk columns and most of mine have just 
been released in book form. The book is called The DOStalk 
Sodipbook. if you like DOS 3.3 or enjoy dumb,jokcs pu ll love it 

! recommend it to those of you who continue to appreciate the 
versatility and ease-of-use of DOS 3..3. The DOStjlK Svidiitnmk 
complements the Information presented in the venctnhic Reneath 
;\pipie DOS in that it gives examples o/how to use Wbrth and Lechner's 
discoveries. 

Newcomers, who may find Apple's DOS 33 manuals difficiilt or 
impossible to bi^ nowadays, will find it particularly uschil. A program 
disk is available separately that includes all the important stuif from 
Uic DOS 3.3 system master, as well as a few surprises >uh, and all 43 of 
the book's programs, tcx)). 

If you were once a reader of Softalk's DOStalk column, some of the 
material in this book may sound ^miliar to you. But it's \x.vn polished 
and reorganized so the first few chapters are all easy material suitable 
for beginners (What is DOS?, In the Beginning was IMIT, Text Files, 
Binary nics), while later chapters have more advanced material (using 
DOS 3.3 from assembly language, using tlie File Manager and RIVTS 
from Basic a Sector Read-Write utility). 

i recommend you go to every book and computer store in town and 
ask for it If they don't have it in stock, make them order it If you can't 
wait you can order it right now from Tab Books, Dept OA-93, P.O. Box 
40, Blue Ridge Summit Pa. 17214 (800-233- 1128). Tab sells the book 
for $14.43. 



159 REN ---ProDOS--- 

169 IF ftWP < > 43643 THEN 388 : t hook in use If not 1iBE83 (syntax err) 
179 X=132 : REM a tB4 to stuff at 1391 for prompt 

200 POKE 1014,0: POKE 1015,3 : REM connect to 4 hook 

210 PRINT CHRJ (4);-BL0HD IHfl.OBJ.flJ300" 

215 POKE 7G9,X: PRINT : REH fix 4301 for 005 in use 

229 PRINT "INPUT. RNVTHINB INSTALLED AND READY.": END 

399 PRINT -ffllPERSBNO VECTOR IN USE." 

310 PRINT "INPUT. SNVTHING NOT INSTHLLED.": END 

After you have these programs working, test things with the keyboard 
input program given above Then try it out for reading disk files. 

The advantages this routine offers over Applesoft's standard IMPUT 
command are that it can get ANY character; it creates less garbage by storing 
shorter strings where longer ones had been; and it automatically divides 
disk strings longer than 255 characters into shorter segments fmr A|>piesoit 
It does this without any loss in speed. Its disacbantages are that its 
supporting machine language routinebraBierfai^andthat it doesn't allow 
aHy editing of keyboard in jxit 

Machine language secrets. The complete source code for InpuLAbso- 
lutely.Anything appears at the end of this article. I present it as meat for the 
assembty language tigers among our subscribers. 

As I indicated eariier, this routine relies heavily on previous work, most of 
which appeared in CaJJ -AFRLE.. The most significant contribution, the use 
of the Applesoft routine FTRQET, first appeared in Meyer's article in AH About 
/^plesofL Our routine calls PTRQET (pointer get) at byte $304. 

PTRQET tells Applesoft that the next item that will appear in the program 
being executed will be a variable. In our case, this is whatever comes after the 
ampersand that calls our routine - the ^ in "8f If thatnediton ism't in 
fact a variable name, propam execution will stop with a SYTfTAX WSSM. 

If it is a variable, PTRC^ finds its descriptor in the variable tables and 
points to the data area of Ihe (tescriptor vrfth VARPTtT— variable pointer— 
(not to be conftised vwth VWtTAB —variable table —which Crossle/s routine 
used). If the variable has never been used before, PTRQET won't find a 
descriptor and it will make a new one This is an extremely powerful call. 

The tip I picked up from Cecil fretwell appears at the very beginning of our 
routine. Both DOS 3.3 and ProDOS look at the PROMPT character to try to 
determine what is going on. If DOS 3.3 finds a question mark — $BF — being 
used as the prompt it figures Applesoft is executing an iriPUT command. 
ProDOS sets the prompt to $84 when an INPUT is executed. To keep Unde 
DOS from getting confused about what's going on we must follow this 
protocol too. 

After setting PROMPT and VARPNT, our next task is read a line of text Since 
it is ri}n€I!Ai{ itsetf that taps control characters, we can't u^ it instead our 
routine ises the Monitor's bivalent of the QET command, RDI^ RDKElf 
pttfs a cursOT up (hi the screen and Jumps to the address stored in the 
^jple's 'Input tester" or "input link". This alwsQfS points to an input routine 
inside DOS. 

DOS looks to see if a disk read is in progress. If so, itimmediately removes 
the cursor from the screen. Have you ever noticed a phantom underiine 
appearing on your screen during disk reads? This is RDKEY's cursor (used by 
NXTCHAR INPUT, and QET). During disk reads it is on the saeen for such a 
short time that the Apple's \iAeo display circuitry usua% catches Just one 
line of it 

If a disk read is NOT in progress, DOS will pass the read call on to the 
current input device. In any event w*en the call returns to our own routine, 
the character read will be in the A register. 

We need to determine if the character is a carriage return, which would 
indicate the end of the line. Since a return can appear as either $0D or $8D, 
depending on whether it is in the lowvalue or high-value ASCII format we 
save the returned character temporarily in the Y register, then clear its high 
bit then test for a return. W^'ll need the low-value ASGI representation of this 
character again later, as thafs what ^plesoil expects to find stored in 
strings. High-value ASCII characters are not con'ectly evaluated t^Applesoflfs 
VAL command. 

Any time DOS sees a call to RDKEY it expects a call to GOUT to follow 
immediately. COUT is the Monitor routine that displays characters on the 
screen — RDKEY doesn't do this. To satisfy DOS's expectations (and to have 
what you type appear on the screen ), if s necessary to send what RDt^Y gives 
us to COUT. 

However, a problem occurs. Some confrol characters do strange and 
wonderful things to the screen when sent to COUT Confrol-U (the fonrard 
anow), for example, turns oif 80<olumn mode. Since we don't want this to 
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happen, our routine traps all control-characters other than return and adds 
$40 to them. This makes them capital letters instead. Depending on what 
mode your screen is in, they appear as flashing (40-column mode), inverse 
(80-column mode without MouseText), or MouseText 

After we've sent the character to COUT we recover the low-value ASCII 
version and check again to see if it is a return. If not, we store it in the 
keyboard input buffer at $200; add one to the X register, which we use as a 
string length counter; and go back to RDl^Y for another character. 

Right in here we also have to check to see if the string is 255 characters 
long yet If it reaches that length before we get a return, we pretend we saw 
one anyhow This happens in the $328-$330 area of our program. If you 
would like your longest sblngs to be less than 255 characters (so you have a 
little room to add stuff to the end of them ), you can POKE a lower value into 
byte 809 ($329). 

Once we get a return, or all the characters we want to handle at one time, 
we stoK the string length for later use. Notice that this length includes the 
cankqentumataieeiKlaftliellii&MtiieGanlasBietim 
a partofthe sMn^lMs iengtt wteiA bealaiedhllKvariablede^ 

but the tnie length of the sbibig is actually (me less than «Aat the desa^)^ 

indicates. This Is what Applesoft ejects. 

Atl9te$336«ieo(miptretheleiithof our newstrbigwith the length ofthe 
strbig this vartabk had befcie itihe newstaing Is dwrter, we niis^t va^ 
overwrite the old one. Ihere we Store dmter sbings depends on whether 
the old string was actual^ stored flie noimai siring storage area or inside 
the program itself. Consider this Ibie 

When a string is defined inside a program like this, it is not moved to the 
normal string storage area In order to save space the variable descriptor 
points right where the string appears in the program. If we didn't check for 
this and stored new shorter strings here, we would change the program 
listing Hot a good idea Tor example, si^we did & A$ and Input "UQUriESb 
IS'.The pragram Aiewoidd nowbe: 

IMe R»:-UGLINE5S IS HCflOINE' 

If you resaved the imgram at this point you'd have a nice mess on wur 
hand& In oid« t» avoid Ms pnriilem we check to see at Iiytes ^454351 
whether flw old sblng is in Ok nonnai sliing Btotage area. If not well sitip 
down to byte $35Band mow ttK Dew venlon up there. V sok we're rea^y to 
can an ApptesoftiattMlDioim as NOVSIR(niow siring); NOV^ 
the length of the string to l]e in the A register, the slitag's curent location in 
theXand Yregisters, and the string's new location in FRESPC We managed to 
fin in II^ESPC while we were checking to see if the string was inside the 
program. We take care of everything else in t^tes $3^^359 and, if the new 
string is to overwrite an old one, we are done. 

On the other hand, if the new string is longer, or replaces one defined 
inside the program, another magical Applesoft routine must bt called. 
Again, Meyer's was the first ofthe works I've mentioned to use it It's called 
QETSFA (get space). Our call to it starts at byte $35B. QETSPA expects the 
length of ttie sMng to be in the A register. It makes room in the string storage 
area for a new sbing. If no room is available, it will force garbage collection, it 
automatically sets up the fVXSK. pdntar NOVSTR needs and returns wiOi 
the string length still in A. 

In this case, we call MOVSTRat bytes $35F-$365. After the string is moved 
we must correct the variable descriptor for the string's new length and 
location ourselves. This occurs at bytes $36&^S. TImi weire done. So's 
this article. Here's the source code 



DFE3: 
E4S2: 
E5E2: 

roec: 
tDED: 



INPUT ABSaUTELY flNVTHING 



by Tim Helshur 

198S 



NOTE 

0633 

eee3: 



a public doMln lubroutlrn 



Bns in b^tes 3»i, 317, 33R. 33F. 34S; (11 others inncct an allots. 

PRDdPT .to S33 eirrant prompt is used as i Flag by OOSit 

FRETOP .in I6F new strings are stored here 

FRESPC .Eq 171 WDVINS' moue-to pointer 

VRRPNT .EO S63 pointer to current variable descriptor 

LBIDG .EQ IFD langtti Df currant string 

nor .£0 S2W lot/bard Input buFfsr 



PTRGET .Eg S0FE3 finds sslictid varltbls and tdjuita VflRPtn 

GCTSm .eg K4SZ Mkas apaea for atrlng atoriga 

N0VS1R .CO KSEZ aows string fnai ans plica to anothar 

RWEV .EQ mc nanttor raad kay rnutlna 

COUT .EQ IFDED Nonltor ehanctsr nut routlna 

.OR %2m 

.IF INPUT. HNVTHINB 



INPUT.flNYTHING 



djmz A9 or 




UK) Mer 


0392: BS 33 




5TR PROMPT 


0304: 29 E3 OF 




JSR PTRGCT 








030S: 20 0C FD 




J5R ROKtV 


D JUL . MD 




TRY 






nun Hf 7r 


A'W- rq An 












0312: 48 




PHR 


flTCa. CO. on 

VJi.J- TV V/ 




BEO 2 


8315: C9 28 




CMP a$20 


8317: Be 83 




ac5 .2 


aim. cA 




nlAt 119^9 


Q31Bs RQ 




IHT 


8310: 98 


.2 


Tffl 


6310: 20 ED FD 




JSR CDUT 


8328: SB 


.3 


PLfl 


8321: 26 




PLP 


TA An 






ftTT... Qn aa at 

yj^ii: yu ov oc 




CTl^ T LiDi ir \/ 
dIH INoUi ,X 


<d327i E8 




I NX 


Isj2d: L0 r r 




CPX 1(255 


832FI: D8 DD 




BME . 1 


e32C: fl3 0D 




tDft 8 $00 


932E: 28 ED FD 




JSR COUT 


8331: 86 FD 


.4 


SIX LENINS 


8333: Bfl 




TXfl 


8334: R8 88 




LDY 350 


8336: Dl 33 




CtIP (VflRPNT] .Y 


8338: F9 92 




BEO^ .5 


833n: a» IF 




BCS .e 


e33C: 91 B3 


.s 


STfl fVftHPHT),V 


e33E: CB 




I NY 


•33F: Bl B3 




LDft ( VflRPNT ).Y 


8341: B5 71 




5Tfi rPESPC 


8343: 43 




Phft 


0344: Ca 




[NY 


0345; Bi B3 




LDfi (VflRPNT), V 


034/: US 




STfl FRESPC+1 


0349: C5 76 




CnP f RETQP+l 


8348: GB 




PLfl 


ISC: 9S ID 




BCC .£ 


834F: C5 GT 




CW FRETOP 


0358: 30 05 




BCC .6 


8352: BR 




Txn 


8353; n2 66 




LDX HINBUF 


a3SS: m 82 




LDV /iNBur 


*3S7: 2«E2ES 




JSRNNSni 


»35A: Bt 




RTS 


035B: an 


.G 




03SC: 29 52 E4 




J5R GETSPfl 


»3sr: fa »» 




LDX itiNeur 


8351: n» 82 




LDY /INeUF 


93S3: 29 E2 ES 




JSR HOVSTR 


83G6: M 88 




LDV III8 


«3S8! fls ro ■* 




LDfl LENINS 


l3Gfl: 91 83 




STfl (VflRPNT), y 


•3GC: C8 




INV 


•3G0: AS Cr 




UK) FRETOP 


nST: 91 83 




sm (wnmi.v 


1371: CS 




m 


9372: RS 7t 




LDfl FRETDP+1 


9374: 91 B3 




STfl (VflRPNT) ,y 


■37E: m 




RTS 



for ProOQS UM $64; for DOS 3.3 usa SBF 
DOS unt eurrant pnMpt u a fl^ 

Dig usir'i virlable out of program, 
and aln VflRPNT at Its dascriptor 

[If first USB, make a descriptor) 

initialiZB string length to zaro 
get a character 
save it in Y 

clear high bit 

chsck for a carriage return 

sava rttult of checU 

sawa ehiractar in R (high bit clQar) 
branch If It uaa a carriage return 

is it any other control character"? 

branch if not 
yes'-add $48 to nake It riashing, inverse, 

or HouatTaxt and slyly slip it into Y 

rscouar original charactar ROKCY rotumod 

and print it 
recovar version ulth high bit ciaar 
reaeeber if it's a carriage return 

branch if it is, us' re done 
otheruise. put it in the keyboard buffer 

and add 1 to the string's length 

is the string 255 characters long yet? 
no, go get another character 
yes, slip CDUT a carriage return even 

though one wasn't really in the file 

end of string; save its length 

move length to ft 

compare length to the length currently 
in the descriptor for this variable 

same length or shorter goes to .5 

if new string is longer goto .6 

save nau length in verlabla's dascriptor 

get current string location from descriptor 
and store at FRESPC for HOVSTR 
aaua low tayta of location 

saoa for hig^ byte 

is string atored In string araa? 

(racovar low byte) 
brantfi to .6 If not, i.a., if string 

is stared In a prograa stataaant, 

dor ' t overuri r e i t 

move string length to fl 

put current address of strir^ in 

X and Y for HOVSTR 
■owo It to liiara ncSPC pointa 
dona 

move string length to ft for GETSPD, which 
makes room in string araa, collecting 
garbage if necessary, and sets up FRES% 

put string adr in X and Y for HOVSTR 

aoua It 

get neu length and store it In variable 

descriptor 

gat nau addrass and atora it In variable 
daacriptor 
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Quick, more pie 

Here's some footnotes to /4pp(eltorfcs Pie (August, 
page 57). You can effectively empty the cliptioard by 
copying an empty space to it Even if you've already 
defined a custom printer, you can still print formatted 
text to disk by "adding" one of tlie listed printers and 
tlien choosing "print onto disk ' when you're asked 
for a slot numiber. The Silentype is a good choice for 
this. 

Debra Hara. whose address you gave on page 61 as 
the source of free documentation on the internal 
structure of AppleWorks files, has moved to Mail Stop- 
3F at Apple. My own lYotes for fippteVloriss will be 
Kfdaced by a nuidrailaiged SyBB( bocdi to be 
released in October. Applied Engineering and Qieck'' 
mate Technology have expanded the data-base- 
records limit to 5J14 and 5i00 respective^, 

Robert En'cson 
Rumford, Rl 

Competition \s a wonderful thing; particularly the 
price and features competition we've seen in 1965 
among the makers (^UgRAM cards for the He. Prices 
have fallen afmost as qtdcMy as the vtppteHbrfcs 
desktop and data j»se haoe gnncn. 

AppteHbrfcs users wW. be interested to know that 
competition now appeals to be Mating up among 
the manufacturers of aads tfiat add a high-speed 
version of the 65C02 microprocessor to the Apple. 
Obviously, It takes longer to sort one of these 
whopping 5,000-record AppleWorks data bases than 
one of the smaller 500-record files that barely fits on 
the standard 55K desktop. Card manufacturers ttiink 
many people who Imve gotten addicted toAppteWorks' 
fast response on small fdes are wiUfng to pa^f for fast 
response on large files as wetL 

The SpeedDemon is such a card; Wicro Computer 
Technologies selis it for $249 (1745 21st St, Santa 
mncia, Calif 90404 215-829-5641). I've had one on 
loan from M-C-T for about a month. Here's the results 
of some tests ! did with the AppleWorks data base: 

EraiiparMtin tlolngs in seconds 

flppleUarks data base file ulth 2,350 records. 
(Apple lie, Sidar hard drive, flE RPMuor)<s card) 



function 


SpgedDemcn 


standard 


faster-factor 


load file 


28 


sa 


l.B 


OS-Find 


9 


26 


2.9 


alpha sort 


22 


S4 


2.4 


ni^meric sort 


25 


£9 


2.8 



fJYote:/4ppteltbrfcssort times depend on the degree 
to whlA a file Is unsoited. Sorting a ^fe that is 
already In neatly the specified order is much quicker 
than the same sort on a file arranged randomly. For 
these tests, pies were shuffled with Identical tech- 
niques before the timing tests. Also note that the file- 



loading tests used a hard drive; floppies are much 
stower on files this large.) 

The SpeedDemon fits in any standard slot of an 
Apple II, lI PIus, or He (even in slot 3 on the He). When 
you turn aSpeedDemonedy1pp/e on, the card takes 
control and turns the computer's built-in 6502 off. 

The SpeedDemon is then off and running. Unfor- 
tunately, however, it can't run at fuii speed all the 
time. Lois ofrouOnes inside the Apple were spedfically 
designed to execute at the speed of the standard 
6502. For example, DOS 5.5 and ProDOS read from 
and write to /loppj^ dislcs using routines that contain 
oMcal timing lootps. If Qie mlooprDCessor isn't 
jnilsing to the best of Us standant slower dock; 
these routines simpljf (font wmk 

Tb compensateforthis, the SpeedDemon carefully 
watches the softswltches for slot 6. V/henever the 
address of one of these disk-drive controlling locations 
appears on the address bus, the SpeedDemon 
sioiiis down to normal speed for 50 microseconds. 
Usually, another reference to slot 6 will appear 
within that length of time and the timer will be 
restarted. Consequenttf^, the ^leedDemon slows 
downasiongasts necessaij^ to re<Hf from or wrtte to 
the disk. 

Optionaliy, you can also make the card slow down 
after references to the softswltches for slots 4 and 5. 
You wmtd do O^ ^ym had a second disk drive 
contrMer inslotS.! had to move my andent pulse- 
diaf JTajjes Mcromodem to slot 4 to slow down the 
speed at which ft dials the phone. (Even then I had to 
put an asteri^ between all the digits of the phone 
numbers to keep my modem software from auto- 
dialing faster than Wa Bell could keep up.) 

The SpeedDemon works fine with the Sider hard 
drive and with revision D and higher of Applied 
Engineering's RAMworks card (some earlier HANworks 
are also supported, ask Applied Engineering for 
more details). The SpeedDemon doesn't work with 
SCRG's quikLoader because both cards try to take 
control when the computer is turned on. 

The people at M-C T tell me they are about to 
release a new version o/the%ieedDemon. With this 
card you wBl be able to conM speed-up for each 
slot bvUMuMly. The newer version will also work 
with Seium Legend, and Prometheus memory 
cards, whldi the current version can't do, and will be 
able to read joysticks and game paddies accurately. 
Unless you are really good, most games play better 
with the SpeedDemon turned off. 

You can disengage the SpeedDemon by turning 
the computer off, back on, pressing escape uMhin 
two seconds, then pressing control-reset. Or POKE 
49243,0 followed by pressing control-reset turns 
the SpeedDemon off from ins'ide a program. 

You can tell when the SpeedDemon is on because 
the standard Apple beep becomes a chirp you7l also 
notice that cursors blink and move faster, that 
screens appear on the screen with more snap, and 
that microprocessor-intenslue taste take only atx)ut 
halfaslongorless. 

My biggest resewation about the card is its price. 
You have to spend lots ofsemnds sitting In front of a 
"mrldi^^^ to make $245 seem insqxnsve. 
Let's hope the kftid of competition we see in the Rm 
card arena spreads to manufariuiers of speed-up 
cards. That will brir^ out more new features and 
lower prices. 

AndconsiderUMOnceyaurcomputerbopemted 
by a microprocessor on a card, why does it haoe to 
be a 65C02? imy not a hi-speed 65802? Does the 
Apple II have any limits at all? 



Enlarging tlie lie 

1 am interested in finding out more about the 256K 
modification to expand Apple Worl& oti Vie lie, I 
would like to know where it goes. If it can be self- 
installed, ifyou've tried (I, and ifyou think its worth it 
This is certainlyasuperfor option tome,coinpared to 
getting a hard disk drive, since i^pple Works is ttie 
main entity 1 would need the expanded memoiy for. 

Tom Mays 
Wichita, Kans. 

/1pplied£ngineering'sZ-ftVf card for the He comes 
with complete installation instiuctjons.v^fimd05tand 
it— I dont have one (yet)— you must open up the 
lie. remove the microprocessor, plug the Z-RAMcard 
into that s)cket, plug the microprocessor Into a 
socket on the card, and attach one wire for the card 
to another flcpin with ad^ of some kind. 

In addition toyourdu^ of an additional 256K or 
512H RAM, you would then have a CP/M computer as 
well. Z-RAM comes with RAM disk software for 
ProDOS, DOS 3.3, Pascal, and CP/M: a CP/M-lIke 
operating system and CP/M manual; and Applied 
Engineering's Apple Works Expand software. 

Among other things, this software allows almost 
all of AppleWorks to load into memory, whichgreatly 
reduces response time— more than a hard disk 
would. The only problem 1 see with AppUed Engi- 
neering's card is that rumors abound that Apple is 
coming out with its own system for adding RAM to 
lies and lies and Apple's system probably wont be 
compatible. (However, it wouldnt surprise me If 
Ap^'ssdiemewasignoredbybuyeisandsofboare 
deueiopm In /ai»r of the scheme used by Ap[M 
OigbteMg and other thiftf>pa% uentfors, Ap^'s 
scheme wff proiMj/prmH, as usual, but it's not a 
sureMngMWsmeJ 

There's ako a rumor that Applied Engineering has 
a lie RAM card in the works that wiU have a dock on if 
Instead of CP/N hardware. Either way, howewer, if 
you're happy with the Z-RAM/AppleWorks combination 
what might foUow tomorrow shouldn't be a m^or 
consideration. 

Il-Plus and extra RAM 

How can the Il-Flus be expanded to 128Kor greater 
by bank-switching, like the lleor lie? 

James Landmark 
Omaha, neb. 

J%mor3/«3>arask)ncarcis^the/l-/1usaneau^abie 
^mseueraldiSrerentconfia(tfes,Th6m#!)rj)mblem 
with these cards is that th^ aS use d^erent bank- 
switching schemes, noneofwhichisfhesameasthe 
scheme used on the lie and lie Hms, very little 
software is available that is(^»bIeofusbtg the extra 
memory, even ifyou harnM 

Sliould have been selected 

We use (and are a dealer for) the PRINT-IT! card 
manufactured by Texprint that you mentioned in the 
July issue (page 53-54). Itworks like the other printer 
interiace card you talked about, but also soi^yow 
m^br reservation — PRIWT-IT does beep and dspk^ 
"NOT SELECTED" onyourtnonitortfyourprinterlsn't 
turned oil Just turn Uk pttaw on and the FTOrrr-IT! 
card contte^immedif^ 

TexpArA now also has Sm-lt This soitoaie, in 
conjunction with flic PWItr-rr! card, will allow you to 
save any saeen into a disk file. 

George A Calder 
Livonia, Mich. 
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The eontral-P conspiracy 

I am intrigued by the following behavior of my 
Apple lie. When I turn the power on and press control- 
reset be^re DOS is loaded, I can enter the Monitor, 
lype "1 ccmtrol-r, and get the contents of ai^ range 
of memory sent to my printer by typing 
addressladdressl 

But if 1 enter the Monitor a/lerDOS is loaded, this 
technique doesn't work. 

The DOS /Yogrammer's Manual lists the values 
that are supposed to appear in the "Output Register" 
at $36-$37 when "1 control-P" is entered (page 125). 
But if DOS is loaded the values at $36-$37 are not 
what the manual says. Will you kindly enlighten me on 
this? 

VedulaN.Murly 
Middletown, Penn. 

When DOS is active, the Output Register and its 
con^)anion Input Register ($38-$59) always point to 
mutines uAthin DOS Itself. This is so that every time 
you type somethins on the keyboard orprintit to the 
screenDOSuMlgettoseettftsLDOSscansMtnput 
and output looking for DOS commands. 

If you want to route output to your printer when 
DOS Is active, use the PR#1 command, even from 
inside the Monitor. DOS will see this message as it 
passes by and ejcecute it. tiowever, even then the 
adual contents of the Output Register mon'f change; 
they'll still point at DOS. DOS 5.3 keeps the true 
Output/Input Registers at $AA53-$AA56. ProDOS 
keeps them at $BE30-BE35. 

If you use the "1 contnA-F' command instead of 
WS urilt not Recognize It as a command. TTie 
Oi^pUt Be^ister be mamentaiily changed as 
descrii>ed in the manual, but you won't see It 
because DOS will erase the new value as it hooks 
itself back up to the Output Register when the next 
character (the return at the end of the command) 
passes by. 

This process is very complex. For a complete 
description, see The DOStalk Scrapbook, Cl^ter 
12, "How the System Operates," pages 81-9L If you 
haoe a stack of old Softali^s, this chapter originani; 
appeared in May 1985, pages 205-210. 

ProDOS and compilers 

I have written a rather large programme, running 
under DOS 3.3, to l^eep records and a mailing list of 
several hundred club members. I've done this by 
reading each member's details into a twodimensional 
ana^, vAndi resides continuous^ in memoiy Although 
this method uses a lot of space, retrieving details 
from the atr^ is much quidier than accessing the 
disk each Hme a record is required. 

The programme works fine. To speed up the 
various searching and sorting routines it contains, I 
complied the entire programme using the TASC 
compiler. The compiled programme also works well 
and of course much, much quicker. 

However, both the Basic and complied versions still 
suffer in speed because of the dreaded Applesoft 
garbage collector. Thus Ih-oDOS, with its much 
improved garbage collection, appeared to be the 
answer. 

The unoompiled&iSk: programme was successiiiUy 
transfered from 0053.3. to ProDOS using COWEW 
and garbage collection no longer appears to Ix a 
problem. The crunch is, though, that the compiled 
version, although transferable to FroDOS, does MOT 
woiIl It appears that the ncm-disk routines in the 



programme all still w(nk,e.&saeen layouts, searching 
sorting, etc Howeva as mm as disk access is 
required, the progranune stops with text like the 

following on the saeen: 

OPEN TE5T,L17a 
KflB TEST.fil 
7 

This is the type of message one would get if FRIliT 
CflR$(4) had been omitted. I have tested this obser- 
vation with oHier shorts pK^Bmmes that I have 
written under DOS 33. comi^ted, then tcansi^md to 
ProDOS. Mi appear to suffer the same problem - 
Basic programs transfer ok, TASC-compiled pro- 
grammes that have no disk reading/writing routines 
are also ok, but TASC-compiled programmes con- 
taining disk routines seem to ignore the PRIMT 
CHR$(4) and come to a grinding halt 

Help (if there is any). If the problem can't be 
overcome, ProDOS goes to the back of my disk 
drawer. 

VKF. Carey 

Athelstone, South Australia 

7b my knowledge, no Appleso/t compilers have 
b^nwr&tenOwtwoikuMProDOS. UnderD0S5.3, 
assembly tai^uage pmgram could "print" DOS 
commands Ju^ Me Appiesofl did and DOS would 
recognize (hem. Ba^i^^m doesn't support this. 
This makes a ProDOS-based y^ppleso/t compiler 
more difficult to write. 

Cecil Fretwell has an artlde in the August Catt ■ 
AP.F.LE. (page 19-25) that discusses this problem 
and offers some possible solutions, lie has told me, 
however, that there Is another significant problem 
with getting a compiler to work with Basicsystem. 
This one has to do with the way Basicsystem moves 
thir^ around in memory when a file is opened and 
uMh keep^ the hvWS gsrbi^ w&ectm from 
messing tMt nmsbrij^ compAed oariafite 

I'm sure someone wM solve these problems 
someday, but It doesn't appear to have fmppened 
yet 

The Sider and software 

I have seen several references to the Sider hard 
drive in Open-Apple, but not much about software 
that will work with it 1 have a Sider and a Il-Plus and 
have never felt a need to "step-up" to FroDOS. I 
decided to order a Sider after using IBM-XTs at work 
and getting spoiled by the speed and ease of operation 
of a hard disk. My unit arrived 12 days after my 
telephone order, lar ahead of the 30 days I was told to 
expect The packing, as you have mentioned, is 
formidable. 

The documentatioQ, ate is Jess ttm tiie packing. 
One particular problem, clarified by the IHendly 
people at their 800 number, is the matter of compati- 
bili^ with other peripherals. The documentation 
casually mentions that removing all non-essential 
boards during setup may be necessary DO IT My 11- 
Plus and the Sider would MOT work at all during 
format if I had more than a 16Kcard in slot 0, floppy 
card in slot 6, and the Sider card in slot 7. 

After formatting (65 DOS 3.3 volumes), I found that 
my two printer cards (connected to dot mabix and 
daisy wheel printers) would not wort( in their usual 
slots 1 and Z Something to do with bus timing, or the 
ws^ I iieshol(fing my mouth that(^, aK3aM<dli^to the 
800 advisor. After moving my printer cards to slots 4 
and 5, 1 was back in operation. 

The next step— what software to use? 1 use my 
s^tem primarily for writing so a word processor was 



my first order of business. I had used the DOS 3.3 
version of Apple Waiter for more than two years 
viMouti»oMems.IYow,hovi^r, I ran smack into the 
wall of copyprotection. 

I finally fbund a word processor that will do most of 
what 1 want— totally within the bounds of the Sider 
environment This is the 5-C Hferd/^ocessorfrom S<, 
Software (P.O. Box 28033, Dallas, TX 75228). The cost 
is $50 and includes WELL commented assembly 
source code. This word processor is unprotected, 
transfers readily to the Sider, uses standard DOS 3.3 
commands (including volume number to load and 
save within the Sider) and has all the usual word 
processing fieatures. 

I have ^tdied my i%rsioa to mm &e QUIT 
command to return to the Sider menu instead of 
Applesoft, and to list only text files when the file 
search option is invoked instead of including binary 
flies such as those created with the old Apple VWter 
10. I'll pass these patches on to anyone who sends 
me a self-addressed stamped envelope. Now the only 
feature I need to print my first novel (when I finish it) is 
a document-chaining facility to print segments as a 
seamless whole Some day, about a year and nine 
days from now at my present rate, I will figure out the 
source code well enough to add that feature. 

The next program I needed was a spreadsheet to 
figure how much money I have lost this year by 
investing in equipment to become a rich and famous 
author Once again, copy protection meant that the 
program I had used for years, VisiCalc, would not 
work. 

The Spreadsheet from A.P.P.LE. CO-OP, 290 SW 
43rd St, Renton WA 98055 fills the bUL The cost is $65 
(no source code) and the proffm uses DOS slpt, 
drive, and volumeparametersFcrhKKlii^mdsayii^ 
You can tran^ it to the Sider i^tog the FiD4fke 
utility tM comes with the difve. It will load my old 
VisiCalc files and even has features my old VisiCalc 
lacks. My tax calculations are tack in operation. 

As well as writing and figuring where all my money 
has gone, I have done some data base work for a 
writer's group. I have been using DB Master #5 but 
you guessed it copy protection struck again. Fortu- 
nately, Stoneware has come up with a version that will 
work with Uie Sider. The mail order houses should 
have this one l^nowfor about$200. 

1 have DB Master's Sider version 16 (they have 
already promised an update) and have not found it to 
be really ready for full use. The m^jor drawback is that 
the program will not actually transfer to the Sider and 
boot— you must put the program disk in your trusty 
old floppy drive, It does work, however. It has all the 
features of regular DB Master, has only one tiny bug 
that 1 can find (in the file restructure utility), and is 
almost worth the price. At least my data files are 
totally on the Sider, eliminating disk swapping for my 
large files. 1 would recommend waiting for the next 
version, however, in the hope that it will run without 
usii^afloi^ 

Ttereym \me% Three pn^ams thatwork under 
DOS 3.3 on a tl-Flus vidth a Sider hffld dtte1\voof the 
three are even priced right How if I can just find a 
decent checkbook program. 

Torn Smith 
1416 nc 98th Ave 
Fort Vmoouver, m 98664 

I've never used either the SC lifwd Processor or 

DB Master, but I can highly agree with your recom- 
mendation o/The Spreadsheet. It recognizes and 
uses the extra memoiy in most RAM cards, works 
u»'th many SO^umn cards, and Is easy for former 
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VisiCalc users to get used to. The same program is 
also sold under the name lACcalc bn the intemafiona/ 
Apple Core and many Apple user groups. 

I trust that anyone who has figured out how to add 
d chain routine to the Word Processor wiU 
contact you. 

Time is Money (Timing Point Software, llA Main 
Street, Watertown, MA 02172. 617-923-4U1) won t 
worfc with a hard drive, saves your data in absolutely 
unaccessible files, and costs too much, nonetheless, 
its speed, flexibility, and capacity more than make 
up for those things. It's the chedfbook/accountlng 
program I use around here and it never ceases to 
iffljjressme. 

IBM compatible Apple 

Lots of people told me it couldn't be done, but I'm 
running MS-DOS programs on my Apple II with a 
Rana 8086/2 and storing MS-DOS files on one of the 
FroDOS partitions of a Sider hard drive. This makes 
for a fascinating and flexible system, it runs Lotus 1-2- 
5 and Rbase, as well as a considerable amount of 
other MS-DOS software (but not Flight Simulator or 
Sidefcic/c). 

I've found that X-Bast, written for the ITT personal 
computer, works fine with the Rana 8086/2 if programs 
turn the cursor on with a IXX^TE HI command. I 
am interested in con-esponding with other Rana 
8086/2 users. 

AlQrimes 
6613 McLean Ct 
McLean, Va. 22101 

>lpp/e Writerand Applesoft 

While browsing through my back issues of Open- 
Apple, 1 came upon your recommendation, in the 
May issue (page 361, to use a word processor to edit 
Basic programs. 1 had intended to write you earlier to 
tell you that I had always thought 1 was the one who 
invented that idea; but never mind— I'm grateful to 
you for spreading the word. 

Despite the advantages you mentioned, I had used 
that technique very little until recently I have a 11-Plus 
and VIdexVideoterm 80-column board, so 1 needed 
to boot the Videx pre-boot disk as well as>lpp/e Writer. 
Then, after writing my Basic code, 1 had to re-boot 
DOS and EXEC my text file. After checking out the 
program, I had to reboot ttie pre-boot and Apple 
Writer to make changes. This was quite a ttiusance. 

To the rescue came a program with the felicitous 
name of OpenAppleWriter. It allows you to switch 
back and forth instantly between >lpp(e Writer and 
Applesoft, using only three keystrokes. OpenApple- 
Writer is a product of CondiCom, 436 Berry Dr, 
Maperville, IL 60540. Their version for DOS 3.3 costs 
$39, their ProDOS version costs $29, both are $49. 

There are other ways in which I use j4pp(e BWterin 
conjunction with Applesoft and DOS. One is to 
examine and repair sequential text files that were 
created by a Basic program and that have been 
messed up. For this purpose, random access flies 
can be converted to sequential files by a Basic 
program such as the one described by Val Qolding in 
CaU -A.P.P.LE. In Depth #3; All About DOS, page 178. 
To enable the program to continue after a bad record 
is encountered, I added an OnERR GOTO routine. If 
the file is really messed up, the program will crash 
just as you described in January (page 2). next time I 
use this program I plan to add your CALL -3288 trick. 

Another thing I do with Apple Writer (in 80-Golumn 
mode) is to lay out titles, column headings, and row 



headings for reports that are to be created with Basic 
programs. Ifs easier to visualize how the report will 
look and to get the spacing and indentation right the 
first time. 1 have my Applesoft program READ the 
heading file as an array of strings and FRIHT each 
string on the appropriate line followed by the computed 
numbers, To preserve leading blanks and embedded 
commas and colons, I start each line in the Apple 
Mt-iter file with a quotation mark. 

I've also reversed the procedure and used Applesoft 
to create files to be printed by Apple Writer. Once, 
when I had nothing better to do, I sketched my club's 
logo on the hi-res screen, then wrote a Basic program 
to convert hi-res memory to an an-ay of bytes that 
could be understood by the graphics mode of my 
printer. With a bit of fiddling I was able to store this 
array as a text file that can be loaded into Apple Writer 
and printed as part of other documents, thus adorning 
club correspondence. 

I'm sure you will be pleased to know that I file my 
copies of Open-Apple in a three-ring binder of 
unknown provenance that is imprinted IBM Data 
Processing. Whatever its original contents may have 
been, its present contents are surely of much g-eater 
value, 

Paul nix 
Summit, M J. 

TTianfcs for your tips. According to other information 
I've seen about OpenAppleWriter, it also does away 
with the Videx pre-boot disk and allows Apple 
Writer to work with hard disk systems under DOS 
5.3. 

Another efficient way to edilApplesoft (or assembly 
language) programs with Apple Writer is to use two 
computers. This gives you all the heneftts of an 
$8,000 multi-tasking machine, but you have two 80 
X 24 windows for your work instead of just one. I 
boot up Apple Writer on the He in front of me and 
QPLE or the S-C Assembler on the ll-Plus to the right 
of me. ! link the two computers together with an 
amazing networking device called the floppy disk. 

The program by Val Goldlng that you mention 
crunches all the empty space out of a random-access 
file; the resulting /tie is not random-access. You can 
get true random files to load Into Apple Writer by 
fBling edl the records unth blanks before you start 
sawing real data Tfiat way your fUe will stfll be 
random-access but Apple Mfriter won't know it and 
will load it normally. 

Two-column format 

Is there a way to achieve a two-column newsletter- 
type format using AppleWorks and an Imagewriter? 

Steve Qreve 
Augusta, Maine 

In Notes for^pleWorks (seey^ugust issue, page 
61) Robert Erlcson suggests the following. Write and 
edityourtext usir^ margin settings thalgiveyouthe 
correct width for one column. Gear a/( tabs, then 
reset a single tab at the right margin. Use the tab and 
return keys to put a return at the end of each line. Use 
open-apple-Z to see what you are doing. Print the 
resulting document to an ASCII file on disk. 

Make a new, one-category, data base file from 
scratch with this ASCII file. Create a table-style report 
and accept the defaults offered. Print this report to a 
D/ffi(e. 

Malce a new spreadsheet file from scratch using 
this DIF file. Widen the spreadsheet's first two 
columns and use the spreadsheet's copy function to 
move text from column to column as needed. The 



spreadsheet becomes a layout surface for your 
whole newsletter. 

l havent tried this trick, but Ina Levinson wrote it 
up for the Houston user group newsletter and 
swears by a IsuspedthaUxxtesforlKikl, underlining 
and alternate character widths will disappear, however, 
which could cause problems. 

A way that avoids loss of bold and underMng is to 
print one column and then roll the paper back 
manually to print the second column. Start this 
technique by making your top and bottom margins 
zero and your page length the actual length you 
want for your columns. Try the Imagewriter's 
Proportional-1 type and fuU Justification. Write and 
edit your letter with margin settings that are correct 
for the first or left-hand column of your newsletter 
(tryanLMof.5,mof4.2}. 

When you are finished editing, use open-apple-K 
to fmd page breaks. Change the margin settings for 
the second page so they are appropriate for the 
second or right-hand column (try an IM of 4.2, RM of 
.5) and put an open-apple-0 "Pti" (Pause here) code 
between the new margin settings and the copy. For 
the third page copy the settings for the first column 
and add a pause; for the fourth, copy the settings for 
the second column; and so on. 

Print the document When the printer pauses the 
first time, manually roll the paper back to the top of 
the first column. When it pauses the second time, 
manually roll the paper to the beginning of the 
second page. It's hard to get the columns exactly 
llned-up with this technique, but all word processor 
features are supported and the results are surprisingly 
good. Sometimes the columns won't come out 
exadly even because AppleWorks wont put a single 
line from a multiline paragraph on a page by Itself 

A third technique is to simply print the whole thing 
in a long single column and use scissors and tape/ 
ghie/wax to put things exactly where you want 
them. That's how Open-Apple and most other 
typeset materials are put together and is probably. 
In the end, the easiest way to get professional- 
looking results. 

40-column He Interrupts 

We have a system that we have used for some time 
that uses interrupts. When we first tried to operate 
this system on an enhanced He, however, it wouldn't 
work. It turns out that on the enhanced lie, interrupts 
are routed through Apple's slot-3 SOcolumn firmware. 
Our problem was that our system runs in 40 columns 
and we don't normally add an 80-column card If no 
80-column card is found, the enhanced lie leaves the 
slot-3 ROM space reading the empty slot and interrupts 
fail to work. 

We soh^ed the problem by pointing the siot-3 ROM 
space at the 80-column firmware with a poke to 
49162 ($C00A). 

Larry Swift 
Clearwater, Fla. 

Con-espondence quality phones 

I understand you made me worid femous recently 
by putting my phone number in a paragraph about 
our user group's use of QBBS II and the Sider for a 
bulletin board system (July, page 53). You neglected 
to notice our newsletter's OBVIOUS several mentions 
of the numbers for BOTH our bulletin board (24 hr 
modem 300/1200, 602-264-3800; name ADAM'S 
APPLE) and our infoline (24 hr voice 602-277-8511 ). I 
don't mind the calls but we have lots of members in 
ADAM II who can give good advice. 
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1 use a lie with a Dumpling 64 printer card and an 
Okidata u92. 1 use AppleWorks as a data base but find 
the AppleWorks word processor limited compared to 
Apple Writer. Among other things, it will not stay in 
correspondence quality. It changes eveiytime you hit 
return. Is there a fix for this problem? AppleWorks 
works beautifully with theCheckmateMultiRam 756K 
card. They just released the 5100 record version, 
WOW!!.. .it will sort that many records In about a 
minuteandahalf. JenyCline, President 

Arizona Desot Apple Menagerie II, Inc. 

Phoenix, Az. 

The AppleWorks word processor automatically 
turns off bold and underlining at the end of every 
paragraph and superscripts and subscripts at the 
end of every line. Thus if "correspondence quality " 
and "bold" are the same thing, correspondence 
quality wUlget turned offeveryUme a retim appears 
in yam file, just as you haoe experienced. 

What you hmrn to do is dive dmm thm^h /^ple- 
mrk's printer (fe^on menus mMym get to the 
place, where AppleWorks asfcs for the BOU) END code 
for your custom printer. Change this code to nothing. 
A/ter that correspondence qu^ty wiU stay on. 

You may stiH need a way to turn correspondence 
quality off. however To do this, find a character 
"pitch" or width between 4-per-inch and 24-pe.r-inch 
that your printer doesnt use. Hardly any printers 
support that many. You can define unneeded ones to 
turn special features of your printer on and off. 

For example, give AppleWorks the code for turning 
bold off as the 4-charactersperinch code. Whenyou 
want to turn correspondence quality off, turn on 4- 
characters-per inch, print a return, then switch back 
to uihateuer character size you reidly want to use. M 
that point in your document AppleWorks will send 
the bold-offcode and a return to your printer. A slight 
prMm uMi Mck is Oat character fritdi can 
onlybedhar^edatthebegbmingofapaiagraph, not 
uMlnone. 

The on/y custom-printer de/inaNe codes that can 
appear within a paragraph are bold, underlining, 
superscript and subscript You can, of course, trick 
AppleWorks by giving these the codes for something 
else, but use care or ApfdeWmks uMl trick you right 
back 



lie serial port noise 



We have been reading serial data through a Super 
Serial Card on a He and ll-Plus, but when we use the 
same program on a lie through serial port 2 we only 
see garbage. It acts like the parity or data format is 
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incorrect but using all of the configurations described 
. in the lie literature the port won't configure to read 
the data correctly We took the lie back to the store 
where we purchased it We wae told that the configu- 
ration had to be set using the lie utility disk and 
would only work in FroDOS. We are in the process of 
rewriting our programs in FroDOS, hut it hardly 
seems reasonable that llie ports can't be configured 
under DOS 

Jeflf Kurtz 
Conyngham, Pa. 

The information your dealer gave you is wrong. 
You can reconfigure either of the lie's ports from 
inside a program under either DOS 3.3 orProDOS. To 
reconfigure port 2, first issue a PRIt1TD$;'Tm2". You 
can then PRUIT any of several port configuration 
commands. All of these begin with a control-A and 
end with a non-contrt^ letter. Some have numbers 
between the control-A and the letter. 

A comfAete list of these commands is in chapter 8 
of the Apple lie reference manual. Many of them— 
including baud rate, data format and parity— are 
the same as the commands for the Super Serial Qad. 
so if you don t have a Wc reference manual use your 
Super Serial Card manual. (Ihe Ik daem't support 
all of the Si^r Serial CsMammaOs, hmeoer.) 

WhmuOUtumanApfieHcOin, portltsautomatt- 
caUy conj^ed like this: 300 baud, 8 data bits, 1 
stop bit no parity. If you change this configuration 
with <«(({{vlthe lie uUiUy disk 4tm#ifl^^tam 
i^fDtf^/^, the new configuration will last untU you 
turn the computer off. Pressing reset or rebooting— 
even booting a DOS 3.3 disk after configuring with 
the ProDOS llcutility disk-wont change the config- 
uration (unless you reboot by turning the computer 
off and back on). 

As mentioned by one of our readers here in June 
(page 47), eatiy Apple lies (serial numbers below 
D51000) have a hardware bug that can cause the 
kind of problem you are experiencing. I suspect this 
is at the root of your trouble. Your dealer is supposed 
to replace the motherboard in your lie without 
charge if you ejqierience this problem- although it 
sounds like your salesman may be unaware of Otis. 
Insist on talking to a technician. 

FP.SYSTEM 

Mow do you get rid of Basicsystem and still have 

yourROMApplesoflathand? , ^ „ 

Lambert tenBeers 

Tokyo, Japan 

/ assume you want to get rid of Basicsystem but 
keep the ProDOS kernel If you don't want the 
ProDOS kernel either, just turn your computer on 
without a disk in the disk drive, then press control- 
reset 

To get rid of Basicsystem but keep the ProDOS 
kemeL use CREATE FP.SYSTEM.TSYS to create a new 
system file. Enter the Monitor and type 2000:4C 00 
EO, thenBSAVErP.SYSTEM,TSYSA$2000,L3. Rename 
any other files on this disk that end with ".SYSTEM"; 
FP.SYSTEM must be the first file in the directory with 
this suffix. 

How boot this disk and the ProDOS kernel will load 
and run FP.SYSTEN. PP.SYSTm sJmpij/ co/dstarts 
ApfAesofl, nothing more. Ba^csystem (and D$ and 
CXMCQ and fast garbarge collection and the psQe- 
Svedors and ioisofoOierstufl) fs gone. It's just you. 
im Applesoft, and the ProDOS MatMae Language 
Interface. The first thing you sfiould do when you 
see the Applesoft prompt is enter HlMEn:4S896 to 
protect the ProDOS globsipage. 



FP.SYSTEM does what you've asked for, but don't 
take it very seriously. It doesn't adhere to the 
conventions of a well-written SYSTEM program. The 
best description of these I have seen is in Gary Utile's 
Apple ProDOS: Advanced Features for Pro- 
grammers, published by Brady Communications, 
pages 139-144. 1 just got this book and havent gone 
throug)\ it thoroughly, but this sectiondoea a terriflc 
job of bringing together in one piace snippets of 
information that Apple scattered throi^h seueral 
manuals and tech notes. There may be sometfting 
missing from the book that I hmen't noticed yet but 
so far it looks tomeUkem improved (and cheaper j 
versim Of Ok ProXlS Techrkal Reference ATanuaL 

Since ipu'ue decided to live without Ba^csystem, 
a guide to the Machine Langauge Interface Is some- 
thing youH reqidre anyhow, so take a look at Uttk'^ 
boot 

Single-drive CONVERT 

flow do you conyert: DOS 3.3 files to ProDOS flies 
with one drive? 

James BBukowski 
St Paul, Minn. 

The lie system utilities will do it if you have a lie 
On oOier Apples use the ProDOS COtWERT program, 
COnVEFT, which has probably done more damage 
to the reputation of ProDOS than mything except the 
FILM was designed to work with one drive. 

However, an undocumented feature was added to 
the program to discourage sb^le-driue users. I 
assume this was becai^ Appie realized QOS 3.3 
was the preferable operating system for single-driBe 
systems. 

In order to use COnVERT with a single drive, you 
muA first attempt to transfer a file in the opposite 
direction from the transfer you actually want to do. 
This initializes some stuff so that transfers in the 
opposite direction will begin to work. Can you 
believe it? 

Nice letters 

I miss the pretty stamps, although I unctorstand 
why you stopped. I hope this is an indfcaBon ^ a 
growing subscription list— you deserve success. 

TR Bainbridge 
Kingsport Tenn. 

For such a small publicadon, Open-j4ppie sure 
packs a tot of punch! The two issues I have read so far 
have had solutions{Jt^s l%Wdouble-h^'ies stuff) 
and hints (Augusrs spec^ the tSsk dM as an 
AppleMspriiiBr)aswdlasfixes(Ausustl%>use%x^ 
COnVERT fix) that will more ttian p^ for ttie cost of a 
year's subscription. 

Colin Mansfield 
Minneapolis, Minn. 

Hfe get lots of complimentary cards and letters that 
we appreciate. Thankyou, everybody. ImeanttoleU 
you a couple of months ago, but forgot that this 
operation started breaicing-euen in June. Open- 
Apple now has more than 2,000 paid subscribers 
and & iKlding a couple hundred or more new sub- 
saiSms each month. (When the kids refused to Uck 
thUmany stamps I was forced to start using a postal 
permit imprint instead.^ 

My intention is to continue packing as much 
useful, relevant, Apple ll-related informaOon into 8 
pages as possible. I'm grateful that so many of you 
appreciate Open-Apple's awesome useful- 
informatiori-per-ounce-of-paper ratio. 



